home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / serien / purity / nr.46 / pcq-crt / crt.dok next >
Text File  |  1995-04-18  |  5KB  |  212 lines
  1.  
  2.     Anleitung zur Crt.lib für PCQ-Pascal
  3.  
  4.     Das komplette Crt-Paket ist © 1995 by Andreas Tetzl
  5.  
  6.     Es darf in jedem nichtkomerziellen Programm verwendet werden,
  7.     solange dieses auf der PURITY veröffentlicht wird.
  8.  
  9.  
  10.     Die Crt.lib bietet Funktionen für die Shell, wie z.B. Cursor
  11.     positionieren, Farben setzen, Cursor an/aus, Zeilen/Spalten
  12.     in Erfahrung bringen und Funktionen für eine Pseudo-Grafik-
  13.     ausgabe für die Shell, wie z.B. "Linien" ziehen. 
  14.     (siehe CrtDemo)
  15.  
  16.  
  17.     Installation:
  18.  
  19.     Kopiert die Datei "Crt.i" in das "Include:Utils/" Verzeichnis
  20.     und die Datei "Crt.lib" in das "lib/" Verzeichnis, in dem auch
  21.     die pcq.lib ist.
  22.     Dann passt euer Make-Script so an, das Blink die Datei crt.lib
  23.     mit an euer Programm linkt.
  24.  
  25.     Beispiel: Blink <in>.p to <out> lib lib/pcq.lib lib/crt.lib
  26.  
  27.  
  28.  
  29. Erklärung der Prozeduren in der Crt.lib:
  30.  
  31.  
  32.  
  33.     Bell
  34.  
  35.    the bell rings - der Hund ringt :-)
  36.  
  37. Parameter:  keine
  38. Funktion:   Bildschirmblitzen
  39. Rückgabe:   keine
  40. Siehe auch: intuition.library/DisplayBeep()
  41.  
  42.  
  43.     ClrScr
  44.  
  45. Parameter:  keine
  46. Funktion:   löscht den Inhalt des Shell-Fensters; Cursor an 1,1
  47. Rückgabe:   keine
  48. Siehe auch: ResetConsole
  49.  
  50.  
  51.  
  52.     CursorOff
  53.  
  54. Parameter:  keine
  55. Funktion:   Schaltet den Cursor aus; er kann durch CursorOn oder 
  56.             ResetConsole wieder eingeschaltet werden
  57. Rückgabe:   keine
  58. Siehe auch: CursorOn, ResetConsole
  59.  
  60.  
  61.  
  62.     CursorOn
  63.  
  64. Parameter:  keine
  65. Funktion:   Schaltet den Cursor wieder an
  66. Rückgabe:   keine
  67. Siehe auch: CursorOff, ResetConsole
  68.  
  69.  
  70.  
  71.     GetConSize
  72.  
  73. Parameter:  Zeile, Spalte
  74. Funktion:   Bringt die Breite und Höhe des Shell-Fensters in
  75.             Zeichen in Erfahrung.
  76.             Achtung: Das Shell-Fenster MUSS das aktive Fenster
  77.                      sein
  78. Rückgabe:   keine
  79. Siehe auch:
  80.  
  81.  
  82.     
  83.     HorizTxtLine
  84.  
  85. Parameter:  x, y, länge, Zeichen
  86.             x,y,länge sind Koordinaten in Zeichen, nicht in Pixeln !
  87.             c gibt das Zeichen an, aus dem die Linie bestehen soll.
  88. Funktion:   "Zeichnet" eine horizontale Linie aus bestimmten ASCII-
  89.             Zeichen in das Shellfenster.
  90. Beispiel:   SetTxtStyle(TS_PLAIN,1,1);
  91.             HorizTxtLine(1,1,10,' ');
  92.                       
  93. Rückgabe:   keine
  94. Siehe auch: TxtLine, SetTextStyle
  95.  
  96.  
  97.  
  98.     Locate
  99.  
  100. Parameter:  Zeile, Spalte
  101. Funktion:   Setzt den Cursor in die angegebene Zeile und Spalte
  102. Rückgabe:   keine
  103. Siehe auch:
  104.  
  105.  
  106.  
  107.     MoveCursorDown
  108.  
  109. Parameter:  Zeilen
  110. Funktion:   Bewegt den Cursor um eine bestimmte Anzahl von Zeilen
  111.             nach unten.
  112. Rückgabe:   keine
  113. Siehe auch: MoveCursorLeft, MoveCursorRight, MoveCursorUp
  114.  
  115.  
  116.  
  117.     MoveCursorLeft
  118.  
  119. Parameter:  Spalten
  120. Funktion:   Bewegt den Cursor um eine bestimmte Anzahl von Spalten
  121.             nach links.
  122. Rückgabe:   keine
  123. Siehe auch: MoveCursorDown, MoveCursorRight, MoveCursorUp
  124.  
  125.  
  126.  
  127.     MoveCursorRight
  128.  
  129. Parameter:  Zeilen
  130. Funktion:   Bewegt den Cursor um eine bestimmte Anzahl von Spalten
  131.             nach rechts.
  132. Rückgabe:   keine
  133. Siehe auch: MoveCursorLeft, MoveCursorDown, MoveCursorUp
  134.  
  135.  
  136.  
  137.     MoveCursorUp
  138.  
  139. Parameter:  Zeilen
  140. Funktion:   Bewegt den Cursor um eine bestimmte Anzahl von Zeilen
  141.             nach oben.
  142. Rückgabe:   keine
  143. Siehe auch: MoveCursorLeft, MoveCursorRight, MoveCursorDown
  144.  
  145.  
  146.  
  147.     ResetConsole
  148.  
  149. Parameter:  keine
  150. Funktion:   löscht den Inhalt des Shell-Fensters; setzt den 
  151.             Text-Modus auf Standard zurück
  152.             => SetTextStyle(TS_PLAIN,1,0);
  153. Rückgabe:   keine
  154. Siehe auch: ClrScr, SetTextStyle
  155.  
  156.  
  157.  
  158.     SetTextStyle
  159.  
  160. Parameter:  Style, Fordergrundfarbe, Hintergr.-farbe
  161. Funktion:   Setzt Text-Modus und -farbe des Shell-Fensters.
  162.             Mögliche Werte für Style:
  163.                 TS_PLAIN     - Normal
  164.                 TS_BOLD      - Fett
  165.                 TS_ITALICS   - Kursiv
  166.                 TS_UNDERLINE - Unterstrichen
  167.             Diese Parameter können auch kobiniert werden, also
  168.             z.B.: TS_BOLD+TS_UNDERLINE für Fett+Unterstrichen
  169.             FrontColor: Farbe für den Text
  170.             BackColor:  Hintergrundfarbe für den Text
  171. Rückgabe:   keine
  172. Siehe auch: ResetConsole
  173.  
  174.  
  175.  
  176.     TxtLine
  177.  
  178. Parameter:  x, y, x2, y2, Zeichen
  179.             x,y,x2,y2 sind Koordinaten in Zeichen, nicht in Pixeln !
  180.             c gibt das Zeichen an, aus dem die Linie bestehen soll.
  181. Funktion:   "Zeichnet" eine Linie mit beliebiger Steigung aus bestimmten 
  182.             ASCII-Zeichen in das Shellfenster.
  183. Beispiel:   SetTextStyle(TS_PLAIN,1,1);
  184.             TxtLine(1,1,8,4,' ');
  185.               
  186.                 
  187.                   
  188.                     
  189. Rückgabe:   keine
  190. Siehe auch: HorizTxtLine, graphics.library/Draw, SetTextStyle
  191.  
  192.  
  193.  
  194.     TxtRectFill
  195.  
  196. Parameter:  x, y, Breite, Höhe, Zeichen
  197.             x,y,Breite,Höhe sind Koordinaten in Zeichen, nicht in Pixeln !
  198.             c gibt das Zeichen an, aus dem das Rechteck bestehen soll.
  199. Funktion:   "Zeichnet" ein Rechteck aus bestimmten ASCII-Zeichen in das 
  200.             Shellfenster.
  201. Beispiel:   SetTextStyle(TS_PLAIN,1,2);
  202.             TxtRectFill(1,1,7,4,' ');
  203.                    
  204.                    
  205.                    
  206.                    
  207. Rückgabe:   keine
  208. Siehe auch: graphics.library/RectFill, SetTextStyle
  209.  
  210.  
  211.  
  212.